home *** CD-ROM | disk | FTP | other *** search
/ C++ für Kids / C++ for kids.iso / SETUP / US / CBUILDER / DATA.Z / WINTRUST.H < prev    next >
C/C++ Source or Header  |  1997-02-13  |  11KB  |  325 lines
  1. /************************************************************************
  2. *                                                                       *
  3. *   wintrust.h -- This module defines the 32-Bit WinTrust definitions   *
  4. *                 needed to build Trust Providers and / Subject         *
  5. *                 Interface Packages.                                   *
  6. *                                                                       *
  7. *   Copyright (c) 1990-1996, Microsoft Corp. All rights reserved.       *
  8. *                                                                       *
  9. ************************************************************************/
  10. #ifndef _WINTRUST_
  11. #define _WINTRUST_
  12. #pragma option -b
  13.  
  14. #ifdef __cplusplus
  15. extern "C" {
  16. #endif
  17.  
  18. #ifdef __BORLANDC__
  19. #pragma option -b.
  20.   #include <pshpack8.h>
  21. #pragma option -b
  22. #endif
  23.  
  24.  
  25. /***********************************************************************
  26. *                                                                      *
  27. * This section contains definitions related to:                        *
  28. *                                                                      *
  29. *                           WinTrust in general                        *
  30. *                                                                      *
  31. ************************************************************************/
  32.  
  33.  
  34. //
  35. // WinTrust Revisioning
  36. //
  37. #define WIN_TRUST_MAJOR_REVISION_MASK       0xFFFF0000
  38. #define WIN_TRUST_MINOR_REVISION_MASK       0x0000FFFF
  39. #define WIN_TRUST_REVISION_1_0              0x00010000
  40.  
  41.  
  42.  
  43.  
  44. /***********************************************************************
  45. *                                                                      *
  46. * This section contains definitions related to:                        *
  47. *                                                                      *
  48. *                           Subject Interface Packages                 *
  49. *                                                                      *
  50. ************************************************************************/
  51.  
  52. //
  53. // Allows passing of subject and type material.
  54. //
  55.  
  56. typedef struct _WIN_TRUST_SIP_SUBJECT {
  57.     GUID *                  SubjectType;
  58.     WIN_TRUST_SUBJECT       Subject;
  59. } WIN_TRUST_SIP_SUBJECT, *LPWIN_TRUST_SIP_SUBJECT;
  60.  
  61. //
  62. // Templates of services that must be EXPORTED by SIPs
  63. // FOR USE by Trust Providers (calling through WinTrust).
  64. //
  65.  
  66. typedef BOOL
  67. (WINAPI *LPWINTRUST_SUBJECT_CHECK_CONTENT_INFO)(
  68.     IN     LPWIN_TRUST_SIP_SUBJECT          lpSubject,          // pointer to subject info
  69.     IN     LPWIN_CERTIFICATE                lpSignedData       // PKCS #7 Signed Data
  70.     );
  71.  
  72. typedef BOOL
  73. (WINAPI *LPWINTRUST_SUBJECT_ENUM_CERTIFICATES)(
  74.     IN     LPWIN_TRUST_SIP_SUBJECT          lpSubject,          // pointer to subject info
  75.     IN     DWORD                            dwTypeFilter,       // 0 or WIN_CERT_TYPE_xxx
  76.     OUT    LPDWORD                          lpCertificateCount,
  77.     IN OUT LPDWORD                          lpIndices,          // Rcvs WIN_CERT_TYPE_
  78.     IN     DWORD                            dwIndexCount
  79.     );
  80.  
  81. typedef BOOL
  82. (WINAPI *LPWINTRUST_SUBJECT_GET_CERTIFICATE)(
  83.     IN     LPWIN_TRUST_SIP_SUBJECT          lpSubject,
  84.     IN     DWORD                            dwCertificateIndex,
  85.     OUT    LPWIN_CERTIFICATE                lpCertificate,
  86.     IN OUT LPDWORD                          lpRequiredLength
  87.     );
  88.  
  89. typedef BOOL
  90. (WINAPI *LPWINTRUST_SUBJECT_GET_CERT_HEADER)(
  91.     IN     LPWIN_TRUST_SIP_SUBJECT          lpSubject,
  92.     IN     DWORD                            dwCertificateIndex,
  93.     OUT    LPWIN_CERTIFICATE                lpCertificateHeader
  94.     );
  95.  
  96. typedef BOOL
  97. (WINAPI *LPWINTRUST_SUBJECT_GET_NAME)(
  98.     IN     LPWIN_TRUST_SIP_SUBJECT      lpSubject,
  99.     IN     LPWIN_CERTIFICATE            lpSignedData,
  100.     IN OUT LPWSTR                       lpBuffer,
  101.     IN OUT LPDWORD                      lpRequiredLength
  102.     );
  103.  
  104. typedef DWORD
  105. (WINAPI *LPWINTRUST_PROVIDER_PING) (
  106.     IN      LPWSTR              lpProviderName,
  107.     IN      DWORD               dwClientParameter,
  108.     OUT     LPDWORD             lpdwServerReturnValue
  109.     );
  110.  
  111.  
  112. typedef struct _WINTRUST_SIP_DISPATCH_TABLE
  113. {
  114.     LPWINTRUST_SUBJECT_CHECK_CONTENT_INFO   CheckSubjectContentInfo;
  115.     LPWINTRUST_SUBJECT_ENUM_CERTIFICATES    EnumSubjectCertificates;
  116.     LPWINTRUST_SUBJECT_GET_CERTIFICATE      GetSubjectCertificate;
  117.     LPWINTRUST_SUBJECT_GET_CERT_HEADER      GetSubjectCertHeader;
  118.     LPWINTRUST_SUBJECT_GET_NAME             GetSubjectName;
  119.  
  120. } WINTRUST_SIP_DISPATCH_TABLE, *LPWINTRUST_SIP_DISPATCH_TABLE;
  121.  
  122.  
  123.  
  124. //
  125. // Structure describing an individual SIP.
  126. //
  127. // This structure is passed back to WinTrust from a Subject Interface Package
  128. // initialization call.
  129. //
  130. typedef struct _WINTRUST_SIP_INFO {
  131.     DWORD                               dwRevision;
  132.     LPWINTRUST_SIP_DISPATCH_TABLE       lpServices;
  133.     DWORD                               dwSubjectTypeCount;
  134.     GUID *                              lpSubjectTypeArray;
  135. } WINTRUST_SIP_INFO, *LPWINTRUST_SIP_INFO;
  136.  
  137.  
  138.  
  139. //
  140. // SIP Intialization routine.
  141. // SIP DLLs are required to have a routine named:
  142. //
  143. //                          WinTrustSipInitialize.
  144. //
  145. // This initialization routine must have the following
  146. // definition:
  147. //
  148.  
  149. typedef BOOL
  150. (WINAPI *LPWINTRUST_SUBJECT_PACKAGE_INITIALIZE)(
  151.     IN     DWORD                            dwWinTrustRevision,
  152.     OUT    LPWINTRUST_SIP_INFO              *lpSipInfo
  153.     );
  154.  
  155.  
  156.  
  157.  
  158. /***********************************************************************
  159. *                                                                      *
  160. * This section contains definitions related to:                        *
  161. *                                                                      *
  162. *                           Trust Providers                            *
  163. *                                                                      *
  164. ************************************************************************/
  165.  
  166. //
  167. // Dispatch table of WinTrust services available to Trust Providers
  168. //
  169. // Client side...
  170.  
  171. typedef struct _WINTRUST_CLIENT_TP_DISPATCH_TABLE
  172. {
  173.     LPWINTRUST_PROVIDER_PING                ServerPing;
  174.     LPWINTRUST_SUBJECT_CHECK_CONTENT_INFO   CheckSubjectContentInfo;
  175.     LPWINTRUST_SUBJECT_ENUM_CERTIFICATES    EnumSubjectCertificates;
  176.     LPWINTRUST_SUBJECT_GET_CERTIFICATE      GetSubjectCertificate;
  177.     LPWINTRUST_SUBJECT_GET_CERT_HEADER      GetSubjectCertHeader;
  178.     LPWINTRUST_SUBJECT_GET_NAME             GetSubjectName;
  179.  
  180. } WINTRUST_CLIENT_TP_DISPATCH_TABLE, *LPWINTRUST_CLIENT_TP_DISPATCH_TABLE;
  181.  
  182.  
  183. // Server side...
  184.  
  185. typedef struct _WINTRUST_SERVER_TP_DISPATCH_TABLE
  186. {
  187.     LPWINTRUST_SUBJECT_CHECK_CONTENT_INFO   CheckSubjectContentInfo;
  188.     LPWINTRUST_SUBJECT_ENUM_CERTIFICATES    EnumSubectCertificates;
  189.     LPWINTRUST_SUBJECT_GET_CERTIFICATE      GetSubjectCertificate;
  190.     LPWINTRUST_SUBJECT_GET_CERT_HEADER      GetSubjectCertHeader;
  191.     LPWINTRUST_SUBJECT_GET_NAME             GetSubjectName;
  192.  
  193. } WINTRUST_SERVER_TP_DISPATCH_TABLE, *LPWINTRUST_SERVER_TP_DISPATCH_TABLE;
  194.  
  195.  
  196. //
  197. // The following structures are passed by WinTrust to a
  198. // Trust Provider being initialized.
  199. //
  200. // Client side...
  201.  
  202. typedef struct _WINTRUST_CLIENT_TP_INFO {
  203.     DWORD                                   dwRevision;
  204.     LPWINTRUST_CLIENT_TP_DISPATCH_TABLE     lpServices;
  205. } WINTRUST_CLIENT_TP_INFO,  *LPWINTRUST_CLIENT_TP_INFO;
  206.  
  207. // Server side
  208. typedef struct _WINTRUST_SERVER_TP_INFO {
  209.     DWORD                                   dwRevision;
  210.     LPWINTRUST_SERVER_TP_DISPATCH_TABLE     lpServices;
  211. } WINTRUST_SERVER_TP_INFO,  *LPWINTRUST_SERVER_TP_INFO;
  212.  
  213.  
  214. //
  215. // Templates of Trust Provider services available to WinTrust
  216. //
  217. typedef LONG
  218. (WINAPI *LPWINTRUST_PROVIDER_VERIFY_TRUST) (
  219.     IN     HWND                             hwnd,
  220.     IN     GUID *                           ActionID,
  221.     IN     LPVOID                           ActionData
  222.     );
  223.  
  224. typedef VOID
  225. (WINAPI *LPWINTRUST_P